home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / loadavg.man < prev    next >
Encoding:
Text File  |  1991-11-01  |  3.5 KB  |  81 lines
  1. ' $Header: /sprite/src/cmds/loadavg/RCS/loadavg.man,v 1.11 90/04/09 10:25:56 douglis Exp Locker: shirriff $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS LOADAVG cmds
  4. .BS
  5. .SH NAME
  6. loadavg, uptime, la, evict \- Interface to the migration load average and idle time database
  7. .SH SYNOPSIS
  8. .nf
  9. \fBloadavg\fR \fB\-l \fR
  10. \fBloadavg\fR \fB\-a \fR
  11. \fBloadavg\fR \fB\-Z \fIhost ... \fR
  12. \fBloadavg\fR \fB\-E \fR
  13. \fBuptime\fR
  14. \fBla\fR
  15. \fBevict\fR
  16. .fi
  17. .BE
  18. .SH INTRODUCTION
  19. This command is used to provide user access to the migration load
  20. average and idle 
  21. time database.  It may be used to retrieve information about the local
  22. host or all hosts on the network, invalidate entries in the migration
  23. database,
  24. or evict foreign processes.  The default for \fBloadavg\fR if invoked with
  25. no arguments is to list the load average of the local host.  This is
  26. also true if the program is invoked as \fBla\fR or \fBuptime\fR, which
  27. are synonyms to make \fBloadavg\fR somewhat compatible with UNIX.  If the
  28. program is invoked as \fIevict\fR, the default is to evict foreign
  29. processes. 
  30. .SH "RETRIEVING INFORMATION"
  31. .IP "\fB\-l\fR"
  32. .IP "\fB\-a\fR"
  33. When invoked with the \fB\-l\fR flag, or with no arguments, \fBloadavg\fR
  34. will print a line containing information about the local host.  
  35. The \fB-a\fR flag is used to list information about all hosts.  
  36. Each
  37. line contains the hostname; machine type; machine status; migration
  38. status; 
  39. 1-minute, 5-minute, and 15-minute weighted load averages; and time
  40. since input was last received at the console, for idle hosts.  
  41. Times are given in the
  42. form ``days+hours:minutes''.
  43. For hosts that are running, the machine status is listed as ``up''
  44. followed by the time since they last rebooted.  The migration status
  45. is ``inuse'' for hosts with one or more active local users, ``avail''
  46. for hosts that are available for migration, ``hasmig''for hosts that
  47. are currently running processes that are migrated from other hosts,
  48. and ``refuses'' for hosts that are idle but are refusing migration
  49. (perhaps because they are running an incompatible version of the
  50. kernel, or because they are file servers).  
  51. In addition, for
  52. hosts that are currently available for migration from the host
  53. invoking \fBloadavg\fR, a \fB*\fR is printed next to the hostname.
  54. After the migration status, \fBloadavg\fR lists the weighted load
  55. averages and time since last input.  Note: idle times of less than the
  56. threshold for permitting migration are not listed, and input from
  57. remote logins does not affect host idle time.
  58. Finally, the machine status is ``down'' for hosts that are not currently
  59. running, in which case the host is listed with the time since it was
  60. last running.
  61. .SH "INVALIDATING INFORMATION"
  62. .IP "\fB\-Z \fIhost ...\fR"
  63. To invalidate the entries for one or more hosts in the shared
  64. migration database, invoke \fBloadavg\fR with the \fB\-Z\fR option,
  65. followed by the names of the hosts to invalidate.  This may be used if
  66. a host is removed from the network, for example.  Hosts that are not
  67. invalidated but are down indefinitely will appear in the list of hosts
  68. as being down.
  69. .SH "EVICTION"
  70. .IP "\fB\-E\fR"
  71. Running \fBloadavg\fR with the \fB\-E\fR option causes it to evict foreign processes
  72. as though the machine were no longer idle.  If \fBloadavg\fR is invoked by the
  73. name \fIevict\fR,  eviction is the default operation.
  74. Eviction is performed by invoking an ioctl on the pseudo-device
  75. corresponding to the host-specific \fBmigd\fR daemon.  
  76. .SH "SEE ALSO"
  77. migd, mig, xload, migcmd
  78. .SH KEYWORDS
  79. eviction, foreign, idle time, load average, process migration,
  80. uptime
  81.